'.\" t
.TH "clstartup" "1M" "Jun 27, 2006" "1\&.2\&.0"
.SH NAME
clstartup \- Tool to start Linuxha.net on machine boot

.SH SYNOPSIS
.TS
l.
clstartup \fBstart\fP
	Form a new cluster on machine boot

clstartup \fBstop\fP
	Stop a currently running cluster
.TE

.SH DESCRIPTION
This is a helper utility that has been designed to work in a number of
ways and is typically run on both nodes as part of the "rc" scripts
that get run when a machine boots or is shut-down. 

Configuration of this tool takes place using a standard file,
called \fIclstartup.xml(5)\fP. See the manual page for that file
for details of the available entries and the functionality they provide.

.SH ARGUMENTS
.TP 4
.B start
Start the cluster - the actions undertaken (such as whether to form with
a single node or not) are defined in the \fIclstartup.xml(5)\fP configuration file.
.TP
.B stop
Stops the cluster - essentially this just calls the \fIclhalt(1M)\fP utility
with the \fB--force\fP option.

.SH EXIT STATUS
As usual if the specified action could not be initiated successfully then
the return code will be non-zero, otherwise 0 [indicating success].

.SH FILES
This utility makes use of the following files:

.TP 4
.B /etc/clstartup.xml
Contains the configuration parameters that determine
how this utility functions under various conditions.

.SH SEE ALSO
.TS
l l.
clform(1M)	- Form the cluster
cldeamon(1M)	- Cluster status Daemon
clstartapp(1M)	- Start a clustered application
clhaltapp(1M)	- Halt a clustered application
clconf.xml(5)	- Overall cluster topology configuration file
appconf.xml(5)	- Configuration of an application used by the cluster
clstartup.xml(5)	- Configuration for cluster formation.
.TE

.SH AUTHOR
The \fIclstartup(1M)\fP utility was written by Simon Edwards, 2003-2006. The
author can be contacted via the website mentioned below.

.SH AVAILABILITY
This software is freely available from the Linuxha.net website - please see
\fBhttp://www.linuxha.net\fP for more details.

.SH WARRANTY
This is Open Source Software is per the GNU GPL. It is free to use and
distribute but \fIcomes with no warranty whatsoever\fP. For more information
on the license please see \fBwww.gnu.org/copyleft/gpl.html\fP.

